home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / com / bbs / protocol / bbzmod61 / bbzmodem.txt < prev   
Encoding:
Text File  |  1996-07-30  |  5.3 KB  |  153 lines

  1.  
  2. Update information for BB-ZMODEM v0.61 beta released on 30 Jul 1996
  3. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
  4.  
  5. * Debugging log is only turned on now when Debug is used, the 
  6.   last version did log heavy Zmodem transfer information.
  7.  
  8.             [ Documentation for BB-ZMODEM v0.60 beta ]
  9.             """"""""""""""""""""""""""""""""""""""""""
  10.  
  11. Hi Guys,
  12.  
  13. Here's a simple Zmodem transfer protocol which you can use with a lot
  14. programms they doesn't have it.  It's not complete but should be good
  15. enough to work fine in practice.  Understand that this programm has
  16. not been tested by many users but don't be affraid to try it out.
  17.  
  18. The basic of this Zmodem transfer module (it does only support the 
  19. ZMODEM!) is based on the sources from BinkleyTerm ST written by 
  20. Bit Bucket Software, i have only written the shell around it and 
  21. modified the most code to be usable as stand-alone Zmodem.  
  22.  
  23. My thanks to these people and to all the other people they did heavy
  24. work on the Atari ST computers and BinkleyTerm including SteVen Green,
  25. Joerg Spilker, Uwe Zerbe, Stephan Slabihoud, Helmut Neumann, Michael
  26. Ziegler (GEM SZRZ!) and Bill Scull who is currently active with BT.
  27.  
  28. I would also thank Jan Kriesten for his serial I/O functions, this
  29. Zmodem module (i call it BB-Zmodem) does make use of these functions.
  30.  
  31. If you all read this you will understand why i can't say that i did
  32. write this programm, i only did have heavy work to get them working
  33. and stripped from BinkleyTerm ST and add the shell about it and add
  34. the GEM/TOS environment possibility.  
  35.  
  36. You must understand that i didn't write it to be better then GEM SZRZ,
  37. if you use that programm then you should not use BB-Zmodem because
  38. GSZRZ is much much better in practice then this, i know it.
  39.  
  40. What are the features of this BB-Zmodem transfer protocol?
  41.  
  42. - It's ofcourse FREE-WARE, do never ask money for it.
  43. - Raw VT52 terminal build-in
  44. - Possible to run as TOS and GEM application, different interfaces!
  45. - Supports some errorlevels
  46. - Usable for the Octopus Bulletin Board System
  47.     
  48. Here's a short help...
  49.  
  50. - Enter '-h or -?' as arguments for command list or nothing to jump in
  51.   raw terminal mode.
  52.  
  53. - Rename this file to BBZMODEM.TOS or BBZMODEM.TTP to use the TOS interface\n"
  54.   instead of GEM (BBZMODEM.APP, BBZMODEM.GTP or BBZMODEM.PRG)
  55.             
  56. - Keys available in terminal mode:
  57.  
  58.     Ctrl-B   Enter new baudrate
  59.     Ctrl-D   Download files
  60.     Ctrl-P   Select another modem port
  61.     Ctrl-U   Upload a file
  62.     Help     Display the help text
  63.     Undo     Quit BB-Zmodem terminal
  64.  
  65. - Other arguments
  66.  
  67.     Usage: bbzmodem <one or more of the following arguments>
  68.  
  69.     - general arguments:
  70.  
  71.         -b <baudrate> (otherwise current baudrate)
  72.         -d Enable debugging log (default turned off)
  73.         -l <name of alternative logfile>
  74.         -p <port> (see bottom list for ports & speeds)
  75.         -q enable quiet mode (less screen output, only in TOS environment)
  76.         -t <time in seconds left> (usable for BBS\'es)
  77.  
  78.         -sz <file> <file> ...
  79.  
  80.         (arguments only usable for sending file(s))
  81.  
  82.             -s <ascii list of files>
  83.             -8 (use 8192 bytes blocks, be sure remote can handle it)
  84.             -w <ascii list of correctly transfered files> (default BBZMODEM.LST)
  85.             
  86.         -rz <pathname>\
  87.  
  88.         (no other special receive arguments)
  89.  
  90.     -  errorlevels:
  91.  
  92.          0 - everything okay
  93.          1 - carrier lost
  94.          2 - usertime up
  95.          3 - transfer aborted by escape
  96.          4 - lack of disk space
  97.          5 - general error
  98.          6 - not enough memory
  99.  
  100.        errorlevels -1 and -2 are removed because they'll threat
  101.        Mag!C with an alert box and stop the system.
  102.             
  103. That's it!   You should when you use it as module from another programm
  104. specify what modem port must be used, the baudrate is optional and not
  105. changed when not specified.
  106.  
  107. To send a few files (available in a filelist) you can use:
  108.  
  109.     BBZMODEM -sz -s filelist -p modem2
  110.  
  111.         (or -p MODEM1, MODEM2, SERIAL1, SERIAL2, MIDI)
  112.     
  113. To receive to the C:\DOWNLOAD\ path you can use:
  114.  
  115.     BBZMODEM -rz c:\download\
  116.     
  117. The carrier is allways checked when the modem port does support it, i 
  118. advice to use HSMODEM or FASTSERIAL because it does increase the speed
  119. a lot in practice.
  120.  
  121. If you don't know the baudrate what they are supported on the modem port
  122. you are using then you should enter a wrong baudrate, if you run in TOS
  123. environment you'll get a list of possible baudrates on your screen of in
  124. the logfile when running as GEM application (default BBZMODEM.LOG).
  125.  
  126. Okay!  I'm at the end of a summary documentation file for this programm,
  127. when you use it and it does not work as it should do or you have ideas
  128. or (not too much critique) then you can contact me on one of the following
  129. addressed:
  130.  
  131.     Koos Kuil    FidoNet   2:282/397      NeST     90:500/103
  132.                   AtariNet 51:1001/104    FAN     190:100/204
  133.       E-mail:        koos_kuil@nextjk.stuyts.nl     
  134.     BBS:        +31-597-618087
  135.     
  136. Remember... i'm not responsible for data damage or something else, if
  137. it doesn't work what you expect from it then you shouldn't use it.
  138.  
  139. Oh yes!     If you use Octopus then you need the following to let it work!
  140.  
  141. DownloadProtocols
  142. {
  143.    Z  Zmodem   0 Batch   c:\octopus\system\filelist  c:\octopus\bbzmodem.gtp "-sz -p modem1 -s c:\octopus\system\filelist "
  144. }
  145.  
  146. and....
  147.  
  148. UploadProtocols
  149. {
  150.    Z  Zmodem   Batch  c:\octopus\bbzmodem.gtp "-rz c:\octopus\online\ -p modem1 "
  151. }
  152.  
  153. *** End ***